home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / today.arc / TODAY.DOC < prev    next >
Text File  |  1986-08-26  |  7KB  |  170 lines
  1.  
  2.                          ---TODAY---
  3.  
  4. OVERVIEW
  5. Have you ever thought it would be nice to know what interesting
  6. things happened on a date in history?  When famous, or not so
  7. famous, birthdays occurred?  TODAY will tell you.  When the program
  8. is run, it looks at the system date, or a date you supply, then
  9. tells you what things of interest happened on that date.  You can
  10. even create a file of dates important to you and be reminded of them
  11. right along with the Marquis de Sade's birthday or the first
  12. commercial radio broadcast.  Just type: TODAY HELP
  13.  
  14. INSTALLATION
  15. TODAY is distributed as an archive file(TODAY.ARC) and you must have
  16. ARC V5.0 or later to extract the required files.  ARC is shareware
  17. from System Enhancement Associates and is available on many computer
  18. bulletin boards.  The files comprising the TODAY system are:
  19.  
  20.        TODAY.DOC - This file
  21.        TODAY.EXE - The program
  22.        TODAY.MON - where MON is JAN thru DEC.  These files contain
  23.                    all the interesting trivia.
  24.        TODAY.OWN - a sample personal TODAY message file
  25.  
  26. After printing this DOC file, you need not keep it on disk but you
  27. will need the EXE and all the MON files.  They MUST all be in the
  28. same directory on your disk.  Why not call it TODAY?
  29. To install TODAY from the root directory, with ARC available, do:
  30.  
  31.      md \today
  32.      cd \today
  33.      arc e today *.*
  34.      cd \
  35.  
  36. This will create a directory called today and un-archive the files
  37. you need to use the system.
  38.  
  39. To run it from your AUTOEXEC.BAT you would insert these three lines:
  40.  
  41.      cd \today
  42.      today once clear wait      (use your choice of options)
  43.      cd \
  44.  
  45. This example would change directories to TODAY's directory, run the
  46. program only once each day, clearing the screen at the beginning and
  47. waiting for a key press at the end before continuing with your BAT
  48. file.
  49.  
  50. HOW TO USE THE PROGRAM
  51. You can just enter TODAY and get the scoop on the current date or
  52. you can optionally enter a date as MMDD, with leading zeros, to see
  53. what happened on a particular date.  There are several options:
  54.  
  55.         MMDD    a date, such as 0401, to use instead of
  56.                 the system date
  57.  
  58.         HELP    will display running instructions
  59.  
  60.         CLEAR   will clear the screen before displaying anything
  61.  
  62.         WAIT    will wait for a key press after the display
  63.  
  64.         ONCE    will only run TODAY once each day.  Without this
  65.                 option it will display msgs each time it is run.
  66.                 Used in an AUTOEXEC.BAT, it will only run TODAY
  67.                 when you turn on your system, not when you reboot.
  68.  
  69. Most of these options are useful when TODAY is run from an
  70. AUTOEXEC.BAT when you turn on your machine.  They cause the program
  71. to only run the first time you boot, not when you re-boot.  You can
  72. clear the screen of previous stuff before today's little gems and
  73. you can have a pause at the end so the messages aren't destroyed by
  74. subsequent programs.  For example:  TODAY CLEAR 0628
  75.  
  76. CUSTOMIZATION
  77. TODAY has one data file for each month of the year.  They are named
  78. TODAY.JAN, .FEB, .MAR etc.  You can also have a personal file named
  79. TODAY.OWN.  This is so all your important dates aren't scattered
  80. among 12 files.  All files are plain vanilla ASCII in this format:
  81.  
  82. Column 1:        The record type which can be a B for birthdays,
  83.                  S for special dates in history or R for a reminder.
  84.  
  85. Cols 2-5:        Month and day as MMDD with leading zeros.  Zeros
  86.                  for either month or day cause ALL months or days
  87.                  to match when being scanned.  For example  0001
  88.                  would match the first of every month while 0400
  89.                  would match every day of April.
  90.  
  91. Cols 6-9:        The full year of the event as four digits.
  92.                  May be left blank, msg will move left.
  93.  
  94. Column 10:       A special processing flag.  Values may be:
  95.  
  96.                  BLANK for no special processing.
  97.  
  98.                  C to continue a message from the previous line.
  99.                  Note, that you MUST repeat the date fields.
  100.  
  101.                  DAY-OF-WEEK DIGIT where 1=Sunday ... 7=Saturday
  102.                  This will cause the message to display only if the
  103.                  date falls on a certain day of the week.  Look in
  104.                  the November file for voting day examples.
  105.  
  106. Cols 11-70       The message to display for this date.
  107.  
  108.                        --EXAMPLES--
  109.  
  110. *mmddyyyy Birthdays
  111. *-------- ------------------------------------------------------------
  112. B09011875 Edgar Rice Burroughs, novelist, Ah-ee-ah-ee-ah!
  113. B09021838 Queen Liliuokalani (last queen of Hawaii).
  114. B09021952 Jimmy Connors, tennis brat
  115.  
  116. *mmddyyyy Events
  117. *-------- ------------------------------------------------------------
  118. S09011939 Germany invades Poland, starts World War II.
  119. S09011952 Sutro Baths purchased by George Whitney.
  120. S0901    2Labor Day, a legal holiday
  121. S09021620 The Mayflower sets sail from Plymouth with
  122. S09021620C102 Pilgrims.
  123.  
  124. *mmddyyyy Reminders
  125. *-------- ------------------------------------------------------------
  126. R0001     Pay the mortgage!
  127. R0401     Taxes due in two weeks.
  128. R0415     Last day to pay taxes!
  129.  
  130. Leave the headings in or you may get a nasty surprise.  Note that
  131. Labor day must be on a Monday and the Mayflower gets two lines of
  132. coverage befitting that momentous event.
  133.  
  134. This format applies to TODAY.OWN also.  You can put in birthdays,
  135. anniversaries, holidays etc.  Messages in your personal file will
  136. tend to be only Birthdays and Reminders.  Also, try putting in
  137. reminders a few days BEFORE the date in question to give youself
  138. some warning.
  139.  
  140. HISTORY
  141. TODAY/PC was written in Datalight C for IBM PC compatible systems by
  142. Patrick Kincaid in July of 1986.  It was inspired by a program
  143. originally written by Mike Butler in PL/1 on an IBM VM/CMS system.
  144. He should be credited with the original concept and the bulk of the
  145. wonderful data in the files.  You will notice a distinct San
  146. Francisco flavor to the databases.  Who says programs can't have
  147. class?
  148.  
  149. USER SUPPORT
  150. Don't send money, send more dates!  I would like the program
  151. distributed far and wide for free with this understanding: if you
  152. like it send me more dates to put in the databases.  This way we can
  153. create real shareware. Don't send the month files with your new
  154. dates added, send the new stuff as listings, in standalone files on
  155. PC diskettes or as electronic mail to me via the Marin-Sonoma PC User
  156. Group BBS (415) 927-1216.  You can mail listings, bugs (features!) or
  157. suggestions to:
  158.  
  159.                     Patrick Kincaid
  160.                    618 Douglas Drive
  161.                  Mill Valley, CA 94941
  162.  
  163. And remember...
  164.  
  165.                    We call it software
  166.                         because
  167.                     we cannot keep it
  168.                            up.
  169.  
  170.